3.4   Requesting Specific API Versions

Because of significant changes in the API introduced in a previous release, MWS possesses a versioned API. The api-version URL parameter can be used to change the requested API version for any call to MWS. The current valid API versions with their corresponding MWS versions are shown in the table below:

API
Version
MWS Version Documentation Notes
2
(deprecated)
7.2.x 7.2.x documentation on Moab Cloud HPC Suite – 7.2 Documentation

As of the 8.0 release, API version 2 is officially deprecated and will be removed from MWS in a future release.

3 8.0 Contained within this document --
latest Latest Contained within this document

When the latest API version is requested, it resolves to the latest API version of MWS, such as api-version=3 for MWS 8.0.

If no API version is specified, the request is rejected. An API version must be specified with every call in MWS.

Chapter 4: Resources and Resources Reference contain information for the latest API version. For documentation of previous API versions, see the table above.

Examples

GET https://localhost:8080/mws/rest/nodes?api-version=2
// Data returned uses API version 2

GET https://localhost:8080/mws/rest/nodes?api-version=latest
// Data returned uses API version 3